Summary

This PR adds a manual calibration bypass script that allows developers and administrators to skip the calibration step during testing. This addresses the feature request in issue #49 to speed up development and debugging workflows.

Fixes : #49

Changes

• Added manual_calibration_bypass.py script that sends a pre-defined valid calibration payload to the API
• The script prompts for a session_id and sends the cached calibration data to the receiveCalibration endpoint
• Includes data sanitization to handle numpy types properly

Motivation

During development and testing, the calibration step becomes repetitive—especially when validating UI flows, reports, or backend processing. Having a way to reuse or inject a valid calibration payload significantly speeds up development and debugging.

How to Use

1. Ensure your Firebase emulator functions URL is set in the .env file as FUNCTIONS_ENDPOINT_URL
2. Run the script: python manual_calibration_bypass.py
3. Enter the session_id when prompted
4. The script will send the valid calibration payload directly to the API, bypassing the need to run the frontend and go through the UI calibration process

Additional Notes

• This feature is intended for development/admin use only
• It does not replace calibration for real user sessions
• The script uses realistic fake data that mimics successful calibration results

Future Considerations

As mentioned in the issue, there are additional approaches that could be explored:

1. A dev-mode toggle in the UI
2. An admin-only endpoint
3. Caching calibration results for reuse

Any suggestions on improving this implementation would be appreciated!